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ABSTRACT 

This guide describes the option switches, operating procedures and 
error messages used by the PDP-11 Preservation program. 

PRESRV is a stand-alone utility which, when loaded into memory, 
overwrites any monitor present and begins execution. 

This manual is directed to the system manager or system programmer who 
wishes to use PRESRV to copy information from one storage device to 
another. PRESRV can be used to copy information from and to disk, 
magnetic tape, cassette and DECtape devices. 

For quick reference to subjects in this guide, use the following list. 

If you need to know about See Section 

Bootstrapping PRESRV 3.1 

Copying identical devices 3.2.1 

Transferring in Logical Tape mode 3.2.3 

Transferring information on a TU16 drive 3.2.2 

Verifying the copy operation 3.2.4 

Copying block-structured devices 3.2.6 

Formatting a disk 4.1 

Determining sufficient buffering space 4.2 
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1.0 INTRODUCTION 



The PDP-11 Preservation Program (PRESRV) is a stand-alone program 
which, when loaded from disk or magnetic tape, overwrites any resident 
monitor present and begins execution. Thus PRESRV runs independently 
of any operating system. PRESRV copies data from disk to disk, disk 
to magnetic tape, magnetic tape to magnetic tape, and (to restore data 
to its original device) from magnetic tape to disk. 

PRESRV supports two classes of devices: 

1. Tape devices (magnetic tape and cassette) , and 

2. Block-structured devices (DECtape and disk). 
Devices supported by PRESRV are listed in Table 1. 



Table 1 
Devices Supported by PRESRV 



Device Mnemonic 



CT 
DB 
DK 
DF 
DP 
DS 

DT 
DX 
MM 

MT 



Device Type 



TA11/TU60 Cassette 
RH11/RP04 and RH70/RP04 Disk Pack 
RK11/RK05 Cartridge Disk 
RFll/RSll Fixed Head Disk 
RP11/RP02/RP03 Disk Pack 
RH11/RS03/RS04 and RH70/RS03/RS04 

Fixed Head Disk 
TC11/TU56 DECtape 
RXll/RXOl Floppy Disk 
RH11/TM02/TU16 and RH70/TM02/TU16 

9-track Magnetic Tape 
TMll/TUlO 7- or 9-track Magnetic Tape 

and TM11/TS03 9-track Magnetic Tape 



Device Class 



Tape 

Block-structured 

Block-structured 

Block-structured 

Block-structured 

Block-structured 

Block-structured 
Block-structured 
Tape 

Tape 



PRESRV commands are of the form: 

outspec/switch= in spec/switch 
where 

is the output device to which the data is copied. 



outspec 
/switch 



is the optional format switch modifying either the 
input or output device or both. 

inspec is the input device from which the data was copied. 

PRESRV operates in one of three modes: image mode, logical tape mode 
and FILES-11 mode. 
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1. 1 Image Mode 

When copy operations are performed in image mode, output format is 
identical to input format. In image mode, PRESRV assumes no knowledge 
of the input device structure and copies all physical blocks, whether 
in use or not, onto the output device. For example, PRESRV reads all 
blocks on DKO: and copies them to DKl:. PRESRV can copy volumes 
containing multiple files and files stored on multiple volumes. If 
the input and output devices are identical, the copy operation is 
automatically performed in image mode unless the user specifies a 
format switch. 

In image mode explicitly, PRESRV separates each file with an 
End-Of-File (EOF) tape mark. When copying information from magnetic 
tape to another tape device, PRESRV assumes the input and output 
volumes are correctly positioned at the load point or positioned after 
an EOF tape mark. After writing each file, PRESRV writes two EOF tape 
marks and then positions the volume between the two EOF tape marks for 
any additional processing. 

If a filelabel is specified when copying information from magnetic 
tape, PRESRV rewinds the input volumes and searches for the specified 
file. A filelabel is a name given to a file written to a logical 
tape. If no filelabel is specified, PRESRV assumes the tape is 
properly positioned (at the load point for the first file or between 
two EOF tape marks for subsequent files) and takes the next file on 
the tape as input. 

NOTE 

1, Filelabels, bootstraps, and system 
images are always written at 800 bits 
per inch (bpi) . Logical tapes written 
with the /PE switch (which writes TU16 
magnetic tape volumes at 1600 bpi) , 
therefore, cannot be copied in image 
mode . 

2. Logical tapes written on a TUlO, TU16, 
or TS03 are bootable interchangeably on 
any of the three magtape devices; 
however, 1600 bpi TU16 tapes are not 
readable on a TUlO or TS03. 

PRESRV can copy multi-volume files; however, no new file can begin on 
the second or subsequent volume of a multi-volume file. 



1. 2 Logical Tape Mode 

In logical tape mode, PRESRV copies information from a disk or 
magnetic tape onto a magnetic tape. In this mode PRESRV copies a core 
image of itself preceding all data records. This image permits PRESRV 
to be bootstrapped from any device containing information to be 
loaded. A logical tape consists of a label block, a bootstrap block, 
a PRESRV image (first volume only) followed by preserved data. See 
Figure 1 for an example of logical tape format. Subsequent volumes 
contain a label block and a dummy bootstrap block followed by data of 
a file started on the first volume. 
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800 BPI 



BPI 



BOOTSTRAP BLOCK 



800 or 
1600 BPI 



End of File 
Indicator 

800 BPI 



PRESRV IMAGE 



DATA 



4&;jD WUXU&3 



256 words 



XX words 



800 
BPI 



EOF 



LABEL BLOCK 



DUMMY BOOTSTRAP 
BLOCK 



800 or 
1600 BPI 



Logical 

End of Tape'l 



End of 
Volume 



DATA 



EOF 



EOF 



EOV 



800 
or 
1600 
BPI 

LEOT 

or 

EOV 



LABEL BLOCK 



DUMMY BOOTSTRAP 
BLOCK 



DATA 



Only one label 
allowed on sub- 
sequent volumes. 
(Must be continu- 
ation of file 
started on first 
volume . ) 



multiple 
labels are 
allowed on 
first volume 



SUBSEQUENT 
VOLUME (S) 



FIRST VOLUME 



Figure 1 Logical Tape Format 
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Bootstrapping the first volume of a logical tape starts PRESRV, so 
that the contents of the logical tape may be copied to another device 
if desired. When a physical or logical tape is produced by PRESRV, 
the user may specify a filelabel of 1 to 12 characters for the image 
to be produced. See Figure 2 for an example of a logical tape label 
block. 



FILE LABEL 



DEVICE NAME 



VOL #/UNIT # 



BLOCK FACTOR 



BLOCK SIZE 



dd 



yy 



hh 



12 characters maximtjin 

Source Device 

Source Unit 

Blocks per record 

512 characters per block 

Date of creation (set by /TIM switch) 



mm 



ss 



SIZE 



Time of creation (set by /TIM switch) 

4 bytes reserved 

Size of PRESRV image (in 256-word blocks) 



Figure 2 Logical Tape Label Block 
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Tape devices (magnetic tape and cassette) are defaulted to logical 
tape mode with the following exceptions: when input and output 
devices are identical, PRESRV copies in image mode unless the user 
specifies a format switch. Also, the output is written in logical 



ha no mry 



r\f^£ 



•tK o "^ ^ K ^^ 



oucpiiL uevice type differs from the input device 



type. For example, if an RKOS'disk cartridge is copied'to an~RP04 
disk pack, the pack is written in logical tape mode. 



1.3 FILES-11 Mode 

^T^ff"!^ ^^ ^^^ ^^^^ structure used by RSX-llM, RSX-llD and IAS. In 
FILES-11 mode, PRESRV copies only blocks in use. Thus FILES-11 mode 
assumes knowledge of the disk file structure, whereas, image mode and 
logical tape mode do not. FILES-11 information blocks are allocated 
to files and include the files themselves. Blocks not allocated to 
files are not copied. If PRESRV is operating in FILES-11 mode and the 
input device is not in FILES-11 format, PRESRV prints the message: 

STORAGE BITMAP FILES READ ERROR 

Retype the command to specify image mode. 

Block-structured devices (DECtape and disk) are always assumed 
m FILES-11 format except when: 



to be 



Input is a disk or DECtape and output is also a 
block-structured device different from the input and without 
a modifying format switch. In this case, the output is 
defaulted to logical tape format. For example, the command 
string 

PRE>DTO : STEVE=DKO : 

creates a file (STEVE) on DTO: in logical tape mode rather 
than in FILES-11 mode. (The filelabel on the output device 
IS required.) This choice was made because the typical copy 
operation between non-identical media is done to create 
backup copies of the system. The resulting output, being in 
logical tape format, contains a bootable image of PRESRV on 
the first volume. 

Both input and output devices are the same type and neither 
IS modified by a format switch. In this case, the copy 
operation is automatically performed in image mode. 



2.0 PRESRV SERVICES 

After the user bootstraps PRESRV and types a command, PRESRV can 
perform the following services: 

1. Make image copies of volumes, 

2. Make copies of volumes in logical tape mode, 

3. Format RK05, RP02, RP03 and RP04 disks, 

4. List labels from volumes in logical tape mode, and 

5. Make copies of volumes in FILES-11 mode. 
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USING PRESRV 



3.1 Bootstrapping PRESRV 

To run PRESRV, mount the device to be copied and bootstrap the device 
on which PRESRV is recorded. 

When PRESRV is bootstrapped, it displays an identification message of 
the form: 

RSX-llS vol BL12 

VOLUME PRESERVATION PROGRAM- V02.1 

FOR HELP TYPE /HE 

nn. BLOCKS AVAILABLE FOR BUFFERING 

PRE> 

PRESRV is built as a task running under the RSX-llS Executive and thus 
displays the version of the stand-alone executive in use, the version 
number of PRESRV, and the number of 256 (10) -word blocks (nn.) 
available for buffering. The user must use the number of blocks 
available for buffering (displayed in the identification message) to 
determine if a given PRESRV media copy has sufficient buffering space. 

If the total space required for input, output and verification 
(optional) buffers is greater than nn. blocks, PRESRV responds with 
the following message: 

INSUFFICIENT BUFFER SPACE 

Abort or retry the operation. 

By typing the /HE command the user is provided with a list of command 
switches and defaults used by PRESRV. /HE is a stand-alone switch and 
must therefore be typed as a separate command. 

CAUTION 

When using RP04 disk pack or TU16 
9-track magnetic tape, it is advisable 
to bootstrap PRESRV from its original 
medium, to configure it if necesssary 
(using the /CSR switch and other 
switches as described in Section 4.4) 
and to write a DEC tape, magtape, 
cassette or floppy disk by preserving 
some volume with a command. For 
example: 

PRE>DTO : ZORG=DK0 :/IM 

A filelabel must be specified if the 
output is in logical tape mode. 
Subsequent booting of the logical tape 
will bring up a user-tailored version of 
PRESRV. The data on the logical tape is 
of no consequence. 
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If PRESRV halts ab location 522 while in the course of trying to 
perform a function, the system has crashed. The probable cause of the 
crash is the use of improper values for the Control Status Register 
(/CSR) or vector address (/VEC) for one of the specified devices in 
the command string. Rebootstrap PRESRV, set the correct CSR and 
vector addresses for the devices in question and retype the command. 
See Section 4.4 for a list of devices and their corresponding CSR and 
vector addresses. 

After the identification message is displayed PRESRV is ready to 
accept a command and responds with PRE> on the console terminal. 
PRESRV accepts command strings containing up to 80 characters. PRESRV 
commands are of the form: 

outspec/switch. ./switch= in spec/switch. ./switch 

Outspec and inspec represent the output and input device respectively. 
Each input or output device has the following format: 

dev:f ilelabel 

where 

dev: is the physical device on which the volume containing 
the desired file is mounted, for example, DKO: The 
name of the device consists of two ASCII characters 
followed by an optional unit number and a colon. If 
no unit number is specified, PRESRV assumes a default 
by assigning a unit number of to the device. 

filelabel is the label given to the logical tape file to be 
copied or created. PRESRV accepts filelabels of 1 to 
12 characters. A filelabel must be specified if the 
output is in logical tape mode. 

If the specified device is not ready or up to speed, PRESRV prints: 

DEVICE NOT READY 

Wait until the device is ready to run, and retry the operation. 

If the device or unit combination specified in the command string is 
not supported by the current PRESRV program or is not a valid device 
for PRESRV operations, PRESRV prints the following message: 

NO SUCH FILE 

Retype the command using the proper filelabel. Output and input 
specifiers can be modified by one of three types of switches: 

/switch a two character ASCII name identifying the switch 
option, or 

/switch:nn \ a two-or three-character ASCII name identifying 

or > the switch option followed by a colon or equal 
/switch=nn ) sign and an alphanumeric value. 

These switches are listed for reference in Table 2. 
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If two conflicting switches are specified in the command string 
example, /TP/FI) , PRESRV prints the following error message: 

CONFLICTING SWITCHES 

Retype the command string with the correct switch(es) specified. 



(for 



Table 2 
PRESRV Option Switch Descriptions 



Option Switch 



Syntax 



Description 



ABORT ON I/O ERROR 



/ER 



BLOCKING SWITCH 



/BL:nn 



LOGICAL TAPE MODE 



REWIND AT COMPLETION 



/TP 



/RW 



Causes termination of the 
current PRESRV operation 
upon an unrecoverable I/O 
error. /ER applies to 
either input or output file 
specifiers but not to both. 

Blocking can be imposed on 
copy operations either on 
logical tapes or 
block-structured devices, 
nn followed by a decimal 
point is the number of 
256 (10) -word blocks in each 
record. Without the 
decimal point, nn is 
interpreted as an octal 
number. The /BL switch can 
apply to either input or 
output file specifiers. 
However, when the input 
volume is a logical tape, 
the input blocking factor 
is overridden by the 
blocking factor of the 
label. 

Overrides an inappropriate 
PRESRV default. On output 
/TP can apply to any device 
and the result of the copy 
operation is a logical 
tape. On input the volume 
to which /TP is attached 
must be in logical tape 
mode . 

Rewinds any physical tape 
that has completed the 
specified copy operation. 
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Table 2 (Cont.) 
PRESRV Option Switch Descriptions 



Option Switch 


syntax 


Description 


TIME AND DATE 


/TIM=mm/dd/yy hh:mm 


Sets the time and date of 
the copy operation. 

mm is the month (1-12) 

dd is the day (1-31) 

yy is the year (0-99) 

hh is the hour (0-23) 

mm is the minute (0-59) 

The /TIM switch is a 
stand-alone switch and must 
therefore be typed in a 
separate command. 


BOOTSTRAP 


dev:/BO 


Causes PRESRV to bootstrap 
the system on the specified 
device, read the first 
block (bootstrap block) and 
pass control to it. 


CONTROL STATUS 
REGISTER 


dev:/CSR=nnnnnn 


Sets the address of the 
Control Status Register to 
nnnnnn, which is the octal 
address of the CSR used by 
the specified device. 


DEVICE SPECIFIC 
SWITCHES 


MTn:/20 


Sets the density of TUlO 
7-track drive n to 200 bpi. 




MTn:/55 


Sets the density of TUlO 
7-track drive n to 556 bpi. 




MTn:/80 


Sets the density of TUlO 
7-track drive n to 800 bpi. 
The /20,/55 and /80 
switches apply only to a 
7-channel TUlO drive being 
copied in image mode . 
These switches may be 
applied to either the input 
or output file specifiers. 


Phase-Encoded 
Tape 


/PE 


Indicates magnetic tape 
volumes, to be written or 
read on a TU16 drive, are 
to be treated in 
phase-encoded mode (1600 
bpi) . The /PE switch may 
appear on either tr' e input 
or output side of che 
command string. 
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Table 2 (Cont.) 
PRESRV Option Switch Descriptions 



Option Switch 



Format Disk 



Vector 



TM02 Formatter 



Unit 



Syntax 



/FO 



FILES-11 MODE 



HELP COMMAND 



/VEC=nnn 



MMn:/TM02=x 



/UNIT=n 



/FI 



/HE 



IMAGE MODE 



LISTING 



/IM 



/LI 



Descr iption 



Enables PRESRV to write the 
necessary timing and sector 
identification information 
on RK05, RP02, RP03 and 
RP04 disks to prepare them 
for storing data. The /FO 
switch may only be 
specified on the output 
side of the command string 
and may be used as a 
stand-alone switch or in 
conjunction with a copy 
operation. 

Sets the interrupt vector 
for a device, nnn is the 
new octal vector address. 

Sets X as the RH unit 

number of the TM02 

formatter for the TU16 tape 
drive n. 

Sets to n the physical unit 
number for a device. The 
/UNIT switch is used to 
refer to units 2 through 7 
in place of either unit 
or 1 of a specified device. 

Overrides an image mode 
copy operation of devices 
not written in FILES-11 
mode. The /FI switch may 
apply to either input or 
output file specifiers. 

Prints a summary of PRESRV 
services. This is a 
stand-alone switch and, 
therefore, must be typed as 
a separate command. 

Overrides the FILES-11 
default in copying 
disk-structured volumes. 

Lists a directory (a list 
of all filelabels) of a 
logical tape. The /LI 
switch is a stand-alone 
switch and must, therefore 
be typed in a separate 
command . 



10 
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Table 2 (Cont.) 
PRESRV Option Switch Descriptions 



Option Switch 


Syntax 


Description 


VERIFY SWITCH 


/VE 


Causes a second pass over 
the input and output media 
so that every block written 
on the output device is 
read back and compared with 
the corresponding block on 
the input device. If the 
comparison fails, a 
verification failure is 
declared. The /VE switch 
may appear on either side 
of the command string. 



3. 2 Primary Command Switches 



3.2.1 Image Mode (/IM) Switch - When copying disk-structured volumes 
to logical tape the Image Mode (/IM) switch overrides the FILES-11 
default. By using the /IM switch an operator can copy any format disk 
to tat>e. For example, the following command string copies information 
on DKO: to MTO: 

PRE>MTO : STAR=DKO : /IM 

A filelabel must be specified when the output is in logical tape mode. 
PRESRV writes 512-character records on magnetic tape unit 0. The /IM 
switch is used to override the FILES-11 default attached to the RK05 
cartridge disk. If the input and the output devices are identical, 
the copy is made in image mode, and the /IM switch is not required. 
If the /IM switch is specified when copying information from a 
magnetic tape to another magnetic tape, PRESRV responds with the 
following error message: 

TRANSFER SPECIFICATION MODE ERROR 

Retype the command without specifying a switch. 

When a tape drive is the output device, PRESRV prints the following 
message : 

MOUNT OUTPUT VOLUME 1. AND TYPE CR> 

Mount the first volume and type the RETURN key. 

If the output volume specified needs a write-ring, PRESRV prints the 
following message: 

OUTPUT VOLUME WRITE-LOCKED. TYPE CR WHEN READY > 
Insert the write-ring and type the RETURN key. 



11 
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3.2.2 Phase-Encoded Tape (/PE) Switch - Magnetic tape volumes to be 
written or read on a TU16 drive are treated in phase-encoded mode 
(1600 bpi) by supplying the phase-encoded tape (/PE) switch. The /PE 
switch must be specified with the filelabel of a TU16 device. For 
example, 

PRE>MMO:filelabel/PE=DBO:/IM 

PRESRV writes the bootstrap block, label block and PRESRV image at 800 
bpi but writes the data from the RP04 disk at 1600 bpi. A block size 
of 1 is used. The /IM switch is used to override the FILES-11 default 
attached to RP04 unit 0. 



3.2.3 Logical Tape Mode (/TP) Switch - The logical tape mode (/TP) 
switch is used to override an inappropriate PRESRV default. On output 
/TP can apply to any device and the result of the copy operation is a 
logical tape. 

On input the volume to which /TP is attached must be in logical tape 
mode. For example, the following command string restores an RK03 or 
RK05 cartridge preserved on DECtape. 

PRE>DKO : =DTO : ART/TP 

The /TP switch is optional in the above example because the filelabel 
attached to the input device indicates logical tape. 



3.2.4 Verification (/VE) Switch - The verification (/VE) switch 
causes PRESRV to verify the copy operation. For example, PRESRV 
compares the output device to the input device to make sure there are 
no differences. 

When the verification operation begins, PRESRV responds with the 
following message: 

**BEGIN VERIFICATION** 

This will cause a second pass over the input and output media so that 
every block written is read back and compared with the corresponding 
block on the input device. When verification is requested, twice the 
number of output buffers is needed. The /VE switch may appear on 
either side of the command string. For example: 

PRE>DK1:/VE=DK0: 
PRE>DK1:=DK0:/VE 

If the verification is successful, PRESRV prints 

PRE> 
and will accept another command. 
If the comparison fails, PRESRV prints the following error message: 

VERIFICATION ERROR nnnnnnn 



12 
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The number printed is the octal logical block number on the output 
device where the error was detected. Retry, continue or abort the 
operation. 

If the voluine to be verified is faulty, PRESRV responds whenever a 
verification error occurs, with the following error message: 

VOLUME FAULTY - "R" TO RETRY, "C" TO CONTINUE> 

Type R to retry or C to continue the operation. 

NOTE 

If the user types the ALTMODE key when 
PRESRV is ready to accept input, the 
current operation is aborted. 



3.2.5 Rewind at Completion (/RW) Switch - The Rewind at Completion 
(/RW) switch enables PRESRV to rewind any physical tape after the copy 
operation has been completed. The /RW switch applies to either input 
or output file specifiers. For example: 

PRE>MT1 : JOAN/RW=DP0 : /IM 

rewinds the tape after information on RP03 unit has been copied to 
magnetic tape unit 1. 



3.2.6 FILES-11 Mode (/FI) Switch - The FILES-11 mode (/FI) switch 
applies only to FILES-11 devices (Disk and DECtape) . The /FI switch 
overrides a default that would result in a PRESRV operation not 
intended by the user. For example, when units are identical and no 
formatting switches are specified, the copy operation is in image 
mode. A FILES-11 copy operation is made by using the /FI switch. The 
/FI switch may apply to either input or output file specifiers. 

NOTE 

If an image copy operation (DK0:=DK1:) 
fails and the input volume is FILES-11, 
use a /FI transfer to copy only blocks 
in use. The blocks that are unreadable 
may be free blocks that do not contain 
data. /FI copy operations take more 
time and should be used only if I/O 
errors occur in an image mode copy. The 
following is an example of an /FI copy 
operation. 

PRE>DK0:/FI=DK1:/FI 
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3.2.7 Abort on I/O Error (/ER) Switch - If the Abort on I/O Error 
(/ER) switch is attached to a file specifier, an unrecoverable I/O 
error causes the termination of the current PRESRV operation. After 
issuing an error message, PRESRV prints 

PRE> 

and is ready to accept another command. 

The /ER switch applies to either input or output file specifiers. For 
example : 

PRE>DK1:/ER=DK0: 

If a write error occurs and the /ER switch has not been specified, 
PRESRV responds with the following message: 

VOLUME FAULTY - "R" TO RETRY, "C" TO CONTINUE> 

Type C to continue or R to retry the operation. 



NOTE 

If the user types the ALTMODE key when 
PRESRV is ready to accept input, the 
current operation is aborted. 



3. 3 Command String Examples 



3.3.1 Disk to Magnetic Tape (TUlO) - The following is an example of 
copying information from a disk to a 7-channel magnetic tape: 

PRE>MT0:filelabel/BL:20./VE=DK0:/IM 

A filelabel must be specified when the output is in logical tape mode. 
The /IM switch overrides the FILES-11 default attached to RK05 unit 
and copies information onto magnetic tape unit in logical tape mode 
at 800 bpi. 

The /VE switch causes a second pass over the input and output media 
after the data on the input device is copied onto the output device. 
Every block written is read back from magnetic tape unit and 
compared with the corresponding block on the input device. 



Because the /EL 
record on the 
method. Normal 
512-character 
interrecord gap 
is wasteful, 
memory is used 
magnetic tape 
for RK05 disk, 
required blocks 



nn switch is specifi 
output tape. Thi 
ly, only one block 
record occupies one 
is three-fourths of 
Verification also u 
for the copy operatio 
copy operation and 
(See Section 4.2 for 
for buffering.) 



ed, PRESRV writes 20 blocks per 
s is the most efficient processing 
per record is used. Since a 
-half an inch on the tape and the 
an inch, a blocking factor of one 
ses 20 blocks. Thus all available 
n: two 20-block buffers for the 
verification and a 12-block buffer 
more information on computing 
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PRESRV requests the user to mount the file output volume by printinq 
the following message: 

MOUNT OUTPUT VOLUME 1 AND TYPE CR> 

After the RETURN key is typed, PRESRV creates the file specified by 
the filelabel. 

Upon copying the data, PRESRV rewinds the tape and performs the 
verification as signalled by the **BEGIN VERIFICATION** message. 
PRESRV continues to request the user to mount subsequent volumes until 
all data on the RK05 has been copied. The end of the copy operation 
is signalled by the PRESRV prompting message (PRE>) . 

If the input device is RP04 , the INSUFFICIENT BUFFER SPACE error is 
generated because the RP04 default is 22 blocks for buffering. Simply 
override the default by using the /BL switch on input as follows: 

PRE>MT0:ZEUS/BL:20./VE=DB0:/BL:11./IM 

A blocking factor of 11 is a submultiple of the number of blocks on 
the volume (167200) and overrides the default of 22. As a result, 
sufficient buffer space is available: two 20-block buffers for the 
magnetic tape copy operation and verification and an 11-block buffer 
for the RP04 disk. 



3-3.2 Magnetic Tape (TUlO) To Disk - To restore a disk from a logical 
tape the following format is used: 

PRE>DPO : /VE=MTO : TERRY 

PRESRV requests the user to mount the first input volume by printing 
the following message: 

MOUNT INPUT VOLUME 1 AND TYPE CR> 

After the RETURN key is typed, PRESRV searches for the file specified 
by filelabel. If the file specified in the command string was not 
found on a logical tape, PRESRV prints the following error message: 

NO SUCH FILE 

Retype the command using a proper filelabel. 

If no filelabel is specified, PRESRV assumes the tape is properly 
positioned (at the load point for the first file or between two EOF 
tape marks for subsequent files) and takes the next file on the tape 
as input. The blocking factor for magnetic tape is taken from the 
filelabel. The blocking factor on output is the default (10) for an 
RP02 or RP03 disk. If the data is continued on a subsequent volume, 
PRESRV prints the following message: 

MOUNT INPUT VOLUME 2 AND TYPE CR> 
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PRESRV checks the filelabel and volume number on magnetic tape unit 
before continuing. If the volume number is incorrect, the following 
message is printed: 

INPUT VOLUME 2 OUT OF SEQUENCE 

Mount the proper volume and proceed. PRESRV continues in this fashion 
until the end of volume is reached. After all reels have been copied, 
PRESRV makes a second pass over the data for verification. The user 
must mount all reels beginning with the first volume and continuing in 
sequence until the last volume is verified. PRESRV uses 10 extra 
blocks of buffer space for the verification. The end of verification 
is signalled by the PRESRV prompting message (PRE>) . 



3.3.3 Disk to Magnetic Tape (TU16) - To copy information from a disk 
to a TU16 magnetic tape the following command string is used: 

PRE>MMO : RICHARD/PE/VE/BL: 20 . =DBO :/IM/BL: 11 

A filelabel must be specified when the output is in logical tape mode. 
The /IM switch is used to override the FILES-11 default in copying 
block-structured volumes to tape. The /PE switch enables PRESRV to 
write data on the TU16 drive at 1600 bpi . PRESRV always writes 
filelabels and bootstrap blocks, however, at 800 bpi. The /BL:20 
switch causes PRESRV to use the most efficient blocking factor as 
described in Section 3.3.1. The /BL:11 switch overrides the 22-block 
default for RP04 and allows sufficient buffer space (51 blocks) for 
the copy operation and verification to occur. The /VE switch causes a 
second pass over the input and output media so that every block 
written is read back from magnetic tape unit and compared with the 
corresponding block on the input device. Action messages are printed 
as described in Section 3.3.1. 



3.3.4 Magnetic Tape (TU16 j To Disk - To restore a disk from a TU16 
magnetic tape written at 1600 bpi the following format is used. 

PRE>DB0:/BL:11./VE=MMQ:RICHARD/PE 

The /PE switch enables the TU16 drive to read the data at 1600 bpi 
(the filelabel is read at 800 bpi). PRESRV reads data from magnetic 
tape unit with the blocking factor it finds in the label record. 
(This blocking factor is 20 if the tape was written following the 
procedures described in the disk to magnetic tape (TU16) copy 
operation shown above. The /BL:11. switch overrides the default 
blocking factor of 22 used for RP04 disks and allows sufficient buffer 
space for verification of a magnetic tape written with a blocking 
factor of 20. (Two 11-block buffers are allocated for copying and 
verifying the RP04 records and one 20-block buffer for the magnetic 
tape records.) Refer to Section 4.2 for a discussion on computing 
required blocks for buffering. 

The /VE switch causes a second pass over the input and output media 
after all reels have been copied. (The action messages are described 
in Section 3.3.2.) Every block written is read back from RP04 unit 
and compared with the corresponding block on the input device. 
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3.3.5 Magnetic Tape (TUlO) bo Magnetic Tape (TUlO) - To copy 
information from a magnetic tape to another magnetic tape the 
following format is used. 

PRE>MT1:=MT0: 

When copying two identical devices, image mode is automatically 

assumed and no switch is needed. If an /IM switch is specified in a 

tape to tape copy operation, PRESRV prints the following error 
message: 

TRANSFER SPECIFICATION MODE ERROR 

Retype the command string without specifying a switch. 

The image copy mode uses the default memory buffer space to create 
blocks on magnetic tape unit 1. {See Section 4.3 for default blocking 
factors.) If any input record is too large, the copy operation is 
aborted. PRESRV assumes the tape is correctly positioned at the load 
point or positioned after an EOF tape mark when no filelabel is 
specified on the input side of the command. 



3.3.6 Magnetic Tape (TU16) to Magnetic Tape (TU16) - To copy 
information from a magnetic tape (TU16) to another magnetic tape 
(TU16) the following format is used: 

PRE>MM1 : /PE/TP=MMO : /TP/PE 

The phase-encoded tape (/PE) switch is used when reading or writing 
information on a TU16 drive written at 1600 bpi. The /TP switch 
overrides the image mode default when copying two identical devices. 



3.3.7 Disk to Disk - To copy information from a disk to another disk 
the following format is used: 

PRE>DP1:=DP0: 

When copying information from a device onto a similar device, image 
mode is automaticlly assumed and a switch is not required. If more 
memory is available, the block (/BL:nn) switch can be used to speed 
the copy operation. 



3.3.8 DEC tape to DEC tape - To copy information from a DECtape to 
another DECtape the following format is used: 

PRE>DT1:=DT0: 

Image mode is automatically assumed when copying information on two 
identical devices. The /IM switch is not required. 



3.3.9 Disk to DECtape - When copying information from a disk to 
DECtape, the following format is used: 

PRE>DT0:IGOR/VE=DK0:/IM 
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A filelabel must be specified on the output side of the command for 
disk to DECtape copy operations or when the output is in logical tape 
mode. The /IM switch is used to override the FILES-11 default 
attached to RK05 unit and copies the information onto DECtape unit 
in logical tape mode. Ten DECtapes are required for copying 
information from one RK05 disk cartridge. The /VE switch causes a 
second pass over the input and output media after information is 
copied to the output reel so that every block written is read back 
from DECtape unit and compared with the corresponding block on the 
input device. 

PRESRV requests the user to mount the first output volume by printing 
the following message; 

MOUNT OUTPUT VOLUME 1 AND TYPE CR> 

After the RETURN key is typed, PRESRV creates the file named IGOR on 
DECtape unit 0. 

Upon copying the data, PRESRV rewinds the tape and performs the 
verification as signalled by the **BEGIN VERIFICATION** message. 
PRESRV continues to request the user to mount subsequent volumes until 
all data on the RK05 device has been copied. The end of the copy 
operation is signalled by the PRESRV prompting message (PRE>) . 



3.3.10 DECtape To Disk - To restore information to a disk from 
DECtape the following format is used: 

PRE>DKO :/VE=DTO : IGOR/TP 

PRESRV requests the user to mount the first input volume by printing 
the following message: 

MOUNT INPUT VOLUME 1 AND TYPE CR> 

After the RETURN key is typed, PRESRV searches for the file specified 
by the filelabel on the input side of the command. If the file 
specified in the command string was not found on a logical tape, 
PRESRV prints the following error message: 

NO SUCH FILE 

Retype the command using a proper filelabel. 

A filelabel is used in the above copy operation because a filelabel 
was specified in the initial copy operation. The /TP switch is 
optional in the above example because the filelabel attached to DTO: 
indicates logical tape. 
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4.0 AUXILIARY OPERATIONS 

4.1 Formatting the Disk - (/FO) Switch 

PRESRV writes the necessary timing and sector identification on RK03, 
RK05, RP02, RP03 or RP04 disks to prepare them for storing data. This 
operation is called formatting the volume and is specified by the /FO 
switch. Formatting may be specified as a separate operation or in 
conjunction with a copy operation. If a copy operation has been 
specified, the disk is formatted before information is copied to it. 

If the device specified for formatting is not one of these devices, 
PRESRV prints the following message: 

DEVICE NOT FORMATTABLE 

Specify the correct device mnemonic. 

The /FO switch may only be specified on the output side of the command 
string. For example: 

PRE>DP0:/FO 

or 

PRE>DPO :/FO/VE=MT0 : DISK 

When formatting begins PRESRV prints the following message on the 
user's terminal. 

**BEGIN FORMATTING** 

If an RP02, RP03 disk is being formatted, however, the format switch 
on the RPll-C controller must be enabled. Perform the following 
steps: 

1. Remove the third panel below the bank of indicator lights on 
the RPll-C controller. 

2. Set the FORMAT ENABLE/NORMAL switch to the FORMAT ENABLE 
position. (It is the switch farthest to the left.) 

3. When formatting is completed, set the FORMAT ENABLE/NORMAL 
switch to the NORMAL position. 

PRESRV prompts the user to enable and disable formatting at the proper 
times by printing the following messages: 

ENABLE FORMATTING WITH SWITCH ON CONTROLLER. TYPE CR WHEN READY> 
or 

DISABLE FORMATTING WITH SWITCH ON CONTROLLER. TYPE CR WHEN READY> 

When the switch is properly set, the user should press the RETURN key 
to continue. When formatting has been completed, PRESRV prints the 
following message: 

**END FORMATTING** 
PRE> 

The PRE> message indicates that another command can be typed. 
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NOTE 

If the user types the ALTMODE key when 
PRESRV is ready to accept input, the 
current operation is aborted. 



4.2 Computing Required Blocks for Buffering 

In the display of the number of blocks available for buffering nn. is 
the number of 256 (10) -word blocks available for data copying and 
verifying operations. The user must use nn. to determine if a given 
PRESRV media copy has sufficient buffering space. The space required 
depends on blocking factors and use of the verification (/VE) switch. 
See Section 4.3 for information on default blocking factors for 
devices supported by PRESRV. 

To determine the blocks needed for PRESRV copy operations, blocks 
required for input, output and verification must be established. 

Example 1: 

PRE>MTO :MARY=DKO :/IM 
creates a logical tape labeled MARY on magnetic tape unit 0. 
Blocking requirements are: 

Input 12. (DK default block size) 

Output 1. (MT default block size) 

Verification 0. (no verification specified) 

Total 13. 

Example 2: 

PRE>DKO : =MTO : HELEN 
copies file HELEN from magnetic tape unit to disk cartridge unit 0. 

Input n. (Record size specified in file HELEN'S label) 

Output 12. (DK default block size) 

Verification 0. (no verification specified) 

Total X. (Output block size plus record size of file 

HELEN) 
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EXAMPLE 3: 

PRE>MTO : LORRY/BL: 20 ./VE=DKO :/IM 

creates a logical tape labeled LORRY on magnetic tape unit 0. The /VE 
switch causes each block written to MTO: to be read and compared to 
the corresponding block on DKO: 

Input 12. (DK default block size) 

Output 20. (MT block size specified by the /BL:20. 

switch) 

Verification 20. (Reread 20 blocks from MTO:) 

Total 52. 

Example 4: 

PRE>DKO : /VE=MTO : SHARON/TP 

copies file SHARON from magnetic tape unit to disk cartridge unit 0. 
Each record written to DKO: is read and compared to the corresponding 
block on the input device. The /TP switch is optional in the above 
example because the filelabel attached to MTO: indicates logical 
tape. 

Input n. (Record size of file SHARON printed in 

output of /LI switch) 

Output 12. (DK default block size) 

Verification 12. (Reread block from DKO;) 

Total X. (Output block size, verification and record 

size of file SHARON) 

Example 5: 

PRE>MM0:=MM1; 

copies the data on TU16 unit 1 to unit at 800 bpi . The image copy 
mode uses all available memory buffer space to create blocks on 
massbus magnetic tape unit 0. If any input record is too large, the 
operation is aborted. 

Example 6: 

PRE>MM0:/VE=MM1: 

is the same as example 4 except that verification is requested. 
One-third of available memory buffer space is used to form blocks to 
be written to MMO:. If any input record is too large, the operation 
is aborted. 
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4.3 Default Blocking Factors - (/BL;nn) Switch 

Blocking can be imposed on copy operations either on logical tape or 
block-structured devices by specifying the blocking (/BL) switch. A 
block is a group of 256-word units that represents the amount of data 
that is copied by a single read or write issued by PRESRV. If the 
number of blocks specified with the /BL switch is too large for the 
available buffer space or is 0, PRESRV prints the following message: 

ILLEGAL BLOCK COUNT 

Retry the operation using a valid block count. 

When PRESRV is loaded, the number of blocks available for buffering is 
printed. PRESRV runs unmapped on the PDP-11 and, therefore, uses a 
maximum of 28K words, 15K words of which are occupied by the executive 
and PRESRV itself. Thus, the current version of PRESRV has available 
13K words, or 52 blocks, for buffering. 

Each device has a default blocking factor that is used by PRESRV when 
no blocking switch is specified, and when buffer space is available to 
perform the default blocking. See Table 3 for default blocking 
factors. 



Table 3 
Default Blocking Factors 



DEVICE 


FORMAT CLASS* 


DEFAULT BLOCK SIZE** 


MAXIMUM BLOCK CAPACITY 


CT 
DB 
DF 
DK 
DP 
DS 
DT 
DX 
MM 
MT 


LT 
BS 
BS 
BS 
BS 
BS 
BS 
BS 
LT 
LT 


1. 
22. 

8. 
12. 
10. 

8. 

2. 

6. 

1. 

1. 


variable 

167200 (RP04) 

1024 per platter 

4800 (RK05) 

40000{RP02), 80000(RP03) 

1024 (RS03) , 2048 (RS04) 

572 (TC11/TU56) 

494 (RXll/RXOl) 

variable 

variable 


*LT denotes Logical Tape. 
BS denotes Block-Structured . 

**The decimal point indicates decimal values. Without the decimal 
point, the values are interpreted as octal numbers. 
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Default blocking factors are overridden as follows: 

1. For block-structured devices the /BL switch can be used on 
either input or output file specifiers to establish a 






2. For logical tape output, a /BL switch can establish the 
blocking factor. 

3. For logical tape input, the blocking factor is always taken 
from the filelabel; the /BL switch is ignored, 

4. If a tape is being copied in image mode, PRESRV uses a 
blocking factor that exhausts all available buffering space. 

The /BL switch is of the form: 

/BL:nn 

where 

nn is the number of 256 (10) -word blocks in each record. These 
blocks may be specified in octal or decimal (with trailing 
decimal point) . 

The /BL switch can apply to either input or output file specifiers. 
For example: 

PRE>DK1 :/BL: 48 . =DKO : 

By specifying a blocking factor of 48. the cartridge disk default 
block size of 12 is overridden. 

When specifying block sizes, a trailing decimal point must be used 

following a base 10 number. If a trailing decimal point is not used 

and an Illegal octal digit (8 or 9) is present, PRESRV prints the 
following error message: 

SYNTAX ERROR 
Retype the command with a decimal point after the base 10 block size. 

NOTE 

1. For image copies, the blocking 
factor specified with a disk or 
DEC tape must be a submultiple of the 
number of blocks on the volume (for 
example, 4800 for DK) . 

2. If buffer space permits, use a large 
blocking factor for DECtape to speed 
the copy operation. 



4.4 Hardware Specific Switches 

Hardware specific switches are acted upon immediately by PRESRV and no 
other commands are accepted until PRESRV completes the current 
command . 
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4.4.1 Control Status Register (/CSR) Switch - To set the control 
status register for a device, use the /CSR switch. The following 
format is used for setting the CSR: 

dev :/CSR=nnnnnn 

where 

dev: is the device whose CSR is to be changed. 

nnnnnn is the octal address of the CSR used by the device. 

For example: 

PRE>DBO:/CSR=176300 

See Table 4 for a list of devices and their corresponding CSR and 
vector addresses. 



Table 4 
Devices and Corresponding CSR and Vector Addresses 



DEVICE 



CT 
DB 
DF 
DK 
DP 
DS 
DT 
DX 
MM 
MT 



CSR 



177500 
176700 
177460 
177404 
176714 
172040 
177342 
171700 
172440 
172522 



VECTOR* 



260 

300 * 

204 

220 

254 

310 * 

214 

264 

320 * 

224 



*The asterisk (*) indicates that this is not a normal vector. 



4.4.2 Vector Address (/VEC) Switch - To set the vector address for a 
device the following format is used: 



where 



dev:/VEC=nnn 

dev: is the device-unit whose vector address is to be changed, 
nnn is the new octal vector address. 
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For example: 

PRE>MM0:/VEC=224 

See Table 4 for a list of devices and their corresponding vector 
addresses. 

Two units (physical unit number and 1) were generated for each 
device type. Both units of each device type are defined as being on 
the same controller. Thus, if the CSR or vector address is changed 
for one unit, it is automatically changed for the other unit. 

All the CSR assignments generated into PRESRV are the normal CSR 
assignments for those devices; however, some of the devices have 
vector addresses that overlap the vectors of other devices. By using 
the /VEC=nnn switch, the normal vectors for those devices can be 
established. 

DEVICE NORMAL VECTOR 

DB 254 

DS 204 

MM 224 

If the generated CSR or vector address does not correspond to the 
actual hardware configuration in use, the /CSR and /VEC commands can 
be used to correct PRESRV generated values. 

CAUTION 

When using an RP04 disk pack or TU16 
9-track magnetic tape, it is advisable 
to bootstrap PRESRV from its original 
medium, to configure it if necessary 
(using the /CSR switch and other 
switches as described in Section 4.4) 
and to write a DEC tape, magnetic tape, 
cassette or floppy disk by preserving 
some volume with a command. For 
example: 

PRE>DTO:ZEUS=DKO:/IM 

A filelabel must be specified on the 
output side of the command string when 
dissimilar devices are specified. 
Subsequent booting of the logical tape 
brings up a user-tailored version of 
PRESRV. The data on the logical tape is 
of no consequence. 



4-4.3 TM02 (/TM02) Switch - The /TM02 switch sets the unit number of 
the TM02 tape formatter on the RH controller. The format is: 

dev:/TM02=n 
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where 

dev: is a device whose TM02 formatter position on the RH 
controller is to be changed. 

n is the unit number desired. 

For example: 

PRE>MM0:/TM02=2 

By using the /UNIT and the /TM02 switches it is possible to set the 
mapping of device mnemonic to the actual physical devices. 



4.4.4 Unit (/UNIT) Switch - The /UNIT switch sets the desired 
physical unit number for a device mnemonic, allowing PRESRV to support 
device configurations with more than one drive of the same device 
type. For example: 

PRE>DK0:/UNIT=2 

sets DKO: to physical unit 2 and every reference to the name DKO: 
actually refers to physical unit 2 on the RHll controller. This is 
the only method of using units other than and 1. Another use for 
the /UNIT switch is for mixed Massbus peripherals. It is possible to 
attach RP04, RS03/04 drives and TM02 tape formatters to the same 
RH11/RH70 controller; however, operating system software may not 
support such a configuration. The /UNIT switch selects the unit 
number of RP04, RS03 and RS04 disk drives on the RH controller or the 
drive number of the TU16 tape drives on the TM02. 

The /CSR, /VEC, /UNIT and /TM02 switches may all be specified on the 
same command line. 



4. 5 Auxiliary Stand-Alone Switches 



4.5.1 Listing (/LI) Switch - The listing (/LI) switch lists from the 
device specified all tape filelabels, the device from which the data 
originated, the volume number, block number, record size, and the date 
and time of the copy operation. The /LI switch is of the following 
format: 

dev:/LI 

The specified device must be formatted as a logical tape. Whether or 
not the device was created with the /PE switch specified, the tape 
labels are always written in 800 bpi mode on 9-track drives. Thus the 
/PE switch is not needed to list the files on a tape created at 1600 
bpi. The /LI switch is a stand-alone switch and must, therefore, be 
typed as a separate command. For example, after typing 

PRE>MT1:/LI 

PRESRV prints a message similar to the following: 

LAB:A FRM:DKO VOL 1. BLK:1. RECSIZ:512. 29-APR-74 00:01:34 
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where 

LAB:A is the name given to a file written to a logical 

tape. 

FRM:DKO is the source device. 

VOL 1. is the volume number of the input device. 

BLK:1. is the number of blocks used in the copy 
operation. 

RECSIZ: 512. is the block size. 512 is the number of 
characters per block. 

29-APR-74 is the date of the copy operation. The default is 
the creation date of the input device. 

00:01:34 is the time of the copy operation. The default is 
the time the input device was created. 



4.5.2 Time (/TIM) Switch - The time (/TIM) switch sets the time and 
date of the copy operation and is of the following format: 

/TIM=mm/dd/yy hh:mm(:ss) 

where 

mm/ is the month (1-12) 
dd/ is the day (1-31) 
yy is the year (0-99) 

hh: is the hour (0-23) 

mm: is the minute (0-59) 

ss is the second (0-59) (optional) 

For example: 

/TIM=8/29/75 15:15 

sets the date of the copy operation to August 29, 1975 and the time to 
3:15. 

All values are decimal without a trailing decimal point. The /TIM 
switch is a stand-alone switch and must, therefore, be specified as a 
separate command. 

The value set by the /TIM switch is used as the base from which the 
date and time of day is calculated. The calculated values are written 
in the label block of logical tapes. If the /TIM switch is not 
specified, PRESRV uses the creation date and time of the input device 
as the base. 
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4. 6 Device Specific Switches 

Device Specific Switches (/20, /55 and /80) define the density of the 
tape and apply only to 7-channel TUlO magnetic tapes operating in 
image copy mode. When 7-channel tape is being used, the copy 
operation must be accomplished in image mode. If no tape density is 
defined, the default is 800 bpi. For example: 

PRE>MT0:/VE=MT1: 
automatically sets the density of the tape to 800 bpi. 

PRE>MT0:/VE=MTl:/55 
sets the density of the tape to 556 bpi. 
PRE>MT0:/VE=MTl:/20 
sets the density of the tape to 200 bpi. 



NOTE 

Logical tapes written on 7-channel 
drives are always in core-dump mode (two 
4-bit frames per byte) . 



5.0 RESTORING THE MONITOR - (/BO) SWITCH 

The PRESRV program is a stand-alone program and thus, runs 

independently of any other system. When PRESRV is completed, the user 

may bootstrap a monitor from unit of a specified device by using the 
bootstrap (/BO) switch. For example: 

PRE>DK0:/BO 

system monitor identification 

The above command string causes a monitor to be read from unit of 
any device and loaded into core. The /BO switch is a stand-alone 
switch and must, therefore, be typed as a separate command. 



6.0 SAMPLE RUN 



The terminal dialogue from a sample run of PRESRV 
RSTS/E system disk (RK) was mounted on drive 
obtain the first two lines of dialogue. A TUlO 
containing PRESRV was then mounted, write prote 
bootstrapped. The first command to PRESRV set the 
RSTS/E disk was then write protected, and a c 
PRESRV to perform an image mode copy of DKO: to f 
Verification was requested, and the blocking fa 
set at the octal number 24 which is equivalent to 
20. 



is shown below. A 

and bootstrapped to 

9-channel magtape 

cted, on drive and 

date and time. The 

ommand was issued to 

ile TSTFIL on MTl: . 

ctor was arbitrarily 

a decimal number of 
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Input 12. (DK default block size) 

Output 20. (MT block size specified by the /BL:24 

(octal) switch) 

Verification 20. (Reread block from MTO:) 

Total 52. 

A zeroed magtape was then mounted, write enabled, on drive 1, and the 
RETURN key was typed to begin the copy. 

Upon completion of the copy, a directory of MTl: was requested to 
verify that the file TSTFIL had been created. 

The RSTS/E disk was then removed from drive 0, and a scratch disk was 
mounted, write enabled, on drive 0. The next command to PRESRV 
requested that the contents of MTl: (TSTFIL) be copied to the scratch 
disk on drive 0. Formatting and verification were requested. When 
PRESRV completed the copy, a command to bootstrap disk was given, 
and the final two lines of dialogue were obtained. Figure 3 below 
shows the terminal dialogue. 
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RSTS V06X-00 SYSTEM #2027 

OPT ton: 



Boot DK|2(: 



Rsx-:i.is yo:i, BL12 

VOLUME PRESERVATION PROGRAM-- y02 . 1 

FOR HELP TYPE /HE 

S2. BLOCKS AVAILABLE FOR BUFFERING 



PRE>/TIM^=K)9/30/75 21 : 00 5 00 • 



PRE>MT1 : TSTFIL/BL 5 24/VE-^^^IiKO : /IM -• 

MOUNT OUTPUT VOLUME 1. ANB TYPE CR> 
** BEGIN VERIFICATION ** 



PRE>MTi:/LI 
LABJTSTFIL 



Boot MT0: 

Set date and time 

Copy DK0: to MT1:TSTFIL 

Obtain directory of MTl: 



frm:dko vol i. blk:20. recsiz: 10240. 30--SEP-75 21:00:00 



PRE>DKO : /F0/VE:=:MT1 : TSTFIL -• 

** BEGIN FORMATTING ** 

** END FORMATTING ** 

MOUNT INPUT VOLUME 1. AND TYPE CRI: 

*« BEGIN VERIFICATION ** 

MOUNT INPUT VOLUME 1. AND TYPE CR; 



Copy MTl: TSTFIL to new DK0: 



^■RE>DKO:/BO -*• 



Boot DK0: 



rsts v06x-00 system #2027 
option: 



Figure 3 Sample Run 
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7.0 ERROR MESSAGE SUMMARY 

During the execution of PRESRV, many checks are made by PRESRV to 
determine the success of the operation. If the check is unsuccessful, 
PRESRV prints one of the messages listed below: 



ERROR MESSAGE 

BITMAP FILE HDR 
READ ERROR 



CONFLICTING SWITCHES 



DEVICE NOT FORMATTABLE 



MEANING 

An attempt has been made 
to perform a copy in 
FILES-11 mode, but the 
input volume is not in 
FILES-11 format. 

Two conflicting switches 
were specified in the 
command string. For 
example, /TP/FI. 

The specified device is 
not accepted by PRESRV. 
Devices accepted by 
PRESRV for formatting 
are RK03/05, RP02/03, 
RP04. 



RECOVERY 

Retype the command 
using either the 
/IM or /TP switch. 



Specify the correct 
swi tch(es) . 



Specify the correct 
device mnemonic. 
(See Table 1 for 
device names) . 



DEVICE OFFLINE 



DICTIONARY READ ERROR 



DRIVE NOT READY 



ERROR IN READING COMMAND 



EXPECTED EOF NOT FOUND 



FATAL ERROR ON INPUT 
DEVICE 



The specified device is 
not in the configuration 
hardware or the Control 
Status Register (/CSR) 
switch is improperly 
set. 

An error occurred in 
reading a dictionary 
(storage bitmap equiva- 
lent) from logical tape. 

The specified drive is 
not readv or w^ to s^eed . 

An error occurred in 
input to the terminal 
or CTRL Z ("Z) was 
illegally typed. 

An End-Of-File (EOF) 
mark was read from the 
input volume but not 
from the output volume 
during the verification 
of a tape image copy. 

An error occurred while 
reading the input volume 
during a tape image copy. 



Set the /CSR and 
vector (/VEC) 
addresses for the 
device to the 
proper addresses. 
Retype the command, 

Retry or abort 
the operation. 



Wait until the 
drive is ready. 

Retype command. 



Retry the operation. 



Retry the operation. 



31 



PDP-11 PRESRV USER'S GUIDE 



ERROR MESSAGE 



MEANING 



RECOVERY 



FATAL ERROR ON OUTPUT 
DEVICE 



HOME BLOCK READ ERROR 



An error occurred while 
reading or writing the 
output volume during a 
tape image copy. 

An attempt has been made 
to perform a copy in 
FILES-11 mode, but the 
input volume is not in 
FILES-11 format. 



Retry the operation, 



Wait until the 
device is ready or 
retype the command 
using the /IM or 
/TP switch to 
specify the proper 
transfer mode. 



ILLEGAL BLOCK COUNT 



INPUT DEVICE ERROR 
nnnnnnn 



The number of blocks 
specified with the 
switch is or is too 
large for the available 
buffer space. 

An error occurred when 
attempting to read data. 
The octal logical block 
number listed is the 
location where the error 
occurred . 



Retry with valid 
block count. (See 
Table 3 for default 
block sizes) . 



None 



INPUT VOLUME nn . OUT OF 
SEQUENCE 



The number of the input 
volume does not match the 
number of the required 
volume. 



Mount the proper 
volume and proceed. 



INSUFFICIENT BUFFER SPACE 



LABEL OR BOOTSTRAP 
WRITE ERROR 



LUN ASSIGNMENT ERROR 



A record on an input 
tape is too large for the 
available buffer space. 
More blocks than are avail- 
able in the buffer are 
needed to complete the 
copy operation. 

An error occurred while 
writing the initial part 
of a logical tape. 

Device or unit combination 
specified in the command 
string is not supported 
by the current PRESRV 
system or is not a valid 
device for PRESRV opera- 
tions. PRESRV recognizes 
only units and 1 unless 
the /UNIT switch is used 
to reassign the reference 
of either or 1. 



Abort or retry 
the operation. 



Retry or abort 
the operation. 



Determine the 
status of the device 
and type the proper 
command . 



NO SUCH FILE 



File named in the command Retype the command 
string was not found on a using a proper 
logical tape, or a magnetic filelabel. 
tape was at End-Of-Volume 
(EOF) for input. 
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ERROR MESSAGE 

OUTPUT DEVICE ERROR 
nnnnnnn 



OUTPUT VOLUME OVERFLOW 



** nnn: — SELECT ERROR 



STORAGE BITMAP FILE 
READ ERROR 



SYNTAX ERROR 



TAPE LABEL READ ERROR 



TAPE WAS WRITTEN FOR dd 



TRANSFER SPECIFICATION 
MODE ERROR 



VERIFICATION ERROR 
nnnnnnn 



MEANING 

An error occurred in 
reading or writing data. 
The number printed is the 
octal logical block 
number where the error 
was detected. 

Input has more blocks 
than the output volume 
(FILES-11) can hold. 



Device is off-line, nnn: 
is the specified device. 

An attempt has been made 
to perform a copy in 
FILES-11 mode, but the 
input volume is not in 
FILES-11 format. 



The command string was 
not a valid command. 

An error occurred when 
reading a logical tape 
label record. 

This is a warning 
message not an error 
message. The FILES-11 
volume being restored 
from a logical tape 
is not of the same type 
as the one from which the 
tape was originally made. 
The new volume is given 
the bitmap of the old 
volume. The characters 
dd identify the intended 
FILES-11 device. 

An inconsistency appears 
in the command string. 
For example, a magnetic 
tape has a /FI switch 
associated with it. 

The data read back from 
the output volume does 
not match what was 
written. The number 
printed is the octal 
logical block number 
on the output device 
where the error was 
detected . 



RECOVERY 

Retry, continue 
or abort the 
operation. 



Try an alternate 
transfer (for 
example. Image 
Mode) . 

Put device on 
line. 

Wait until the 
device is ready 
or retype the 
command specifying 
the proper transfer 
mode {/IM or /TP) . 

Retype the command 
string correctly. 

Retry or abort the 
operation. 



None 



Retype an 
acceptable 
command . 



Retry, continue 
or abort the 
operation . 
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The most important references to subjects are underlined. 



Abort copy operation, see Copy 

operation, abort of 
Abort on I/O Error (/ER) switch, 

8, 14 
ALTMODE key , 13 , 14,20 
Auxiliary command switches, 19 
Auxiliary stand-alone switches, 

see Stand-alone switches 



Bootstrap (/BO) switch, 9, 28 
Buffering blocks, 6, 14, 15, 16, 
22, 22 
computing required blocks, 20 
disk to magnetic tape, 14, 16 
magnetic tape to disk, 15, 16 
Buffer space, see Buffering 
blocks 



BEGIN FORMATTING message, 19 
BEGIN VERIFICATION message, 

12, 15, 18 
/BL (Blocking) switch, 8_, 16, 

17, 22, 23 
Block 

bootstrap, 2, 12 
buffering, see buffering 

blocks 
definition of, 22 
dummy bootstrap, 2 
information, FILES-11, 5 
logical tape label, 2, 4, 

12 
maximum capacity, 22 
size, 22 
Blocking (/BL) switch, 8^, 16, 

17, 22, 23 
Blocking factors, default, 
see Default blocking 
factors 
Blocking requirements, 20 
Block-structured devices, 1, 
5, 22 
blocking factors, 22, 23 
RFll/RSll fixed head disk, 

1 
RH11/RP04 disk pack, 1 
RH11/RS03/RS04 fixed head 

disk, 1 
RH70/RP04 disk pack, 1 
RH70/RS03/RS04 fixed head 

disk, 1 
RK11/RK05 cartridge disk, 1 
RP11/RP02/RP03 disk pack, 1 
RXll/RXOl floppy disk, 1 
TC11/TU56 DECtape, 1 
see also specific device 
listings 
/BO (Bootstrap) switch, % 28^ 
Bootstrap, bootstrapping, 2, 
5, 25, 28, 29 
block, 2, 12 
dummy block, 2 
procedures , 6 



Cassette devices , see Magnetic 

tape devices 
Command ( s ) 

format, 1 

inspec/switch, 1, 7 

outspec/switch, 1, 7 

used by PRESRV, obtaining list 

of, 6 
see also Switches primary 
command 
Command switches, obtaining list 

of, 6 
CONFLICTING SWITCHES message, 8, 

31 
Control Status Register (/CSR) 

switch, 6, 7, 9, 24, 26 
Copy operations 

abort of, 6, 13, 14, 17, 20, 21 
blocking of, 22 
DECtape to DECtape, 17 
DECtape to disk, 18 
disk to DECtape, 17 
disk to disk, 5, 17 
disk to magnetic tape (TUlO) , 14 
disk to magnetic tape (TU16) , 16 
FILES-11, see FILES-11 mode 
identical media, 1, 11, 17 
image mode, see Image mode 
logical tape, see Logical tape 

mode 
magnetic tape (TUlO) to disk, 

15 
magnetic tape (TU16) to disk, 

16 
magnetic tape (TUlO) to magnetic 

tape (TUlO) , 17 
magnetic tape (TU16) to magnetic 

tape (TU16) , 17 
multi-volume files, 2 
non-identical media, 5 
verification of, 12, 14, 15, 16, 
18, 21 
Core-dump mode, 28 
CSR address, 24, 25 
/CSR (Control Status Register) 
switch, 6, 7, 9, 24, 26 
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Date default, 27 
Decimal point, trailing, 23 
DECtape, 1, 13, 17, 18, 23 
Default blocking factors, 
14 - 19, 20 - 23 
DECtape requirements, 23 
disk to disk, 17 
disk to magnetic tape, 14, 

16 
magnetic tape to disk, 15, 

16 
magnetic tape to magnetic 

tape, 17 
table of, 22 
Default Blocking Factors (/BL) 

switch, 22, 23 
Default block size, 22 

trailing decimal point, 23 
Default (s) 

block-structured devices, 5 
FILES-11, 11, 14 
tape devices, 5 
time and/or date, 27 
used by PRESRV, obtaining 
list of, 6 
Density, tape, 9, 28 
DEVICE NOT FORMATTABLE message, 

19 
DEVICE NOT READY message, 7 
DEVICE OFFLINE message, 31 
Devices 

block-structured, 1, 5, 22 
block-structured, list of, 1, 
see also Block-structured 
devices 
classes, 1 
CSR address, 24, 25 
directory listing, obtaining, 

26 
mounting, 6 
support, 1 
tape, 1, 5, 23 
tape, list of, 1, see also 

Magnetic tape devices 
vector address, 24 
verification, 6, 12 
Device-specific switches 
setting density to 200 bpi 

(/20), 9, 28 
setting density to 556 bpi 

{/55) , 9, 28 
setting density to 800 bpi 
(/80) , 9, 28 
DICTIONARY READ ERROR message, 

31 
DISABLE FORMATTING WITH SWITCH 
ON CONTROLLER. TYPE CR 
WHEN READY message, 19 



Disk devices, see Block- 
structured devices 

Disk restoration, 12, 15, 16, 18 

Disk to DECtape copy operation, 
17 

Disk to disk copy operation, 17 

Disk to magnetic tape (TUlO) copy 
operation, 14 

Disk to magnetic tape (TU16) copy 
operation, 16 

DRIVE NOT READY message, 31 

Dummy bootstrap block, 2 

ENABLE FORMATTING WITH SWITCH ON 

CONTROLLER. TYPE CR WHEN 

READY message, 19 
END FORMATTING message, 19 
End-of-file tape mark, 2, 17 
EOF (end-of-file) tape mark, 2, 17 
/ER (Abort on I/O Error) switch, 

14 
ERROR IN READING COMMAND messaqe, 

31 
Error, I/O, 8, 13, 14 
Error message summary, 31 - 33 
EXPECTED EOF NOT FOUND message, 31 

FATAL ERROR ON INPUT DEVICE 

message, 31 
FATAL ERROR ON OUTPUT DEVICE 

message, 32 
Faulty volume, 13 

/FI (FILES-11 mode) switch, 10, 13 
Filelabel — 

definition of, 2 
printing list of, 10 
use of, 2, 4, 7, 11, 14 - 18, 25 
FILES-11 mode, 1, 5 
default, 11, 14 
information blocks, 5 
FILES-11 mode (/FI) switch, 10, 13 
Files, multi-volume, 2 
/FO (Formatting Disk) switch, 5, 

10, 19 
Format 

command , 1 
device, 7 
logical tape, 3 
Format Enable/Normal switch, 19 
Formatting disk (/FO) switch, 5, 

10, 19 
Formatting RP02 or RP03 disk, 19 
Functions of PRESRV, 5 
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Hardware specific switches 

/CSR, 6, 7, 9, 24, 26 

/TM02, 10, 25, 26 

/UNIT, 10, 26 

/VEC, 7, 10, 24 - 26 
HELP (/HE) command, 6, 10 
HOME BLOCK READ ERROR messacie, 
32 



IAS system, 5 

Identification, sector, 19 
Identification, timing, 19 
ILLEGAL BLOCK COUNT message, 

22, 32 
Image mode, 1, 2, 5, 11, 13, 

17, 21 
Image mode (/IM) switch, 10, 
11, 12, 14, 16, 17, 18" 
/IM (Image Mode) switch, 10, 
11, 12, 14, 16, 17, 18~ 
Information blocks, FILES-11, 5 
INPUT DEVICE ERROR message, 32 
INPUT VOLUME 2 OUT OF SEQUENCE 

message, 16, 32 
Inspec, modification of, 7 
Inspec/switch, 1, 7 
INSUFFICIENT BUFFER SPACE 

message, 6, 32 
I/O error, 8, 13, 14 



Label block, 2, 12 

Label block, logical tape, 4 

LABEL OR BOOTSTRAP WRITE ERROR 

message, 32 
/LI (Listing) switch, 10, 26 
Listing (/LI) switch, 10, 2F 
Location 522, 7 
Logical tape 
format, 3 
label block, 4 
mode ,1,2 
(/TP) switch, 12 
Logical tape devices, see 
Magnetic tape devices 
Logical Tape mode (/TP) switch, 

8, 12, 17, 18, 21 
LUN ASSIGNMENT ERROR message, 
32 



Magnetic tape 

(TUlO) to disk copy operation, 
15 

(TU16) to disk copy operation, 
16 



Magnetic tape (cont.) 

(TUlO) to magnetic tape (TUlO) 

copy operation, 17 
(TU16) to magnetic tape (TU16) 
copy operation, 17 
Magnetic tape devices, 1 
blocking factors, 22, 23 
RH11/TM02/TU16 magnetic tape 

{9-track) , 1 
RH70/TM02/TU16 magnetic tape 

(9-track) , 1 
see also specific device 

listings 
TA11/TU60 cassette, 1 
TM11/TS03 magnetic tape (9- 

track) , 1 
TMll/TUlO magnetic tape (7- or 
9-track) , 1 
Massbus peripherals, mixed, 26 
Media, non-identical, 5 
Memory requirements, PRESRV, 22 
Messages 

BEGIN FORMATTING, 19 
BEGIN VERIFICATION, 12, 15, 18 
CONFLICTING SWITCHES, 8, 31 
DEVICE NOT FORMATTABLE, 19, 31 
DEVICE NOT READY, 7, 31 
DEVICE OFFLINE, 31 
DICTIONARY READ ERROR, 31 
DISABLE FORMATTING WITH SWITCH 
ON CONTROLLER. TYPE CR WHEN 
READY, 19 
DRIVE NOT READY, 31 
ENABLE FORMATTING WITH SWITCH 
ON CONTROLLER. TYPE CR WHEN 
READY, 19 
END FORMATTING, 19 
ERROR IN READING COMMAND, 31 
error, summary, 31 - 33 
EXPECTED EOF NOT FOUND, 31 
FATAL ERROR ON INPUT DEVICE, 31 
FATAL ERROR ON OUTPUT DEVICE, 32 
HOME BLOCK READ ERROR, 32 
ILLEGAL BLOCK COUNT, 22, 32 
INPUT DEVICE ERROR nnnnnnn, 32 
INPUT VOLUME 2 OUT OF SEQUENCE, 

16, 32 
INSUFFICIENT BUFFER SPACE, 6, 

15, 32 
LABEL OR BOOTSTRAP WRITE ERROR, 

32 
LUN ASSIGNMENT ERROR, 32 
MOUNT INPUT VOLUME 1 AND TYPE 

CR, 15, 18 
MOUNT INPUT VOLUME 2 AND TYPE 

CR, 15 
MOUNT OUTPUT VOLUME 1 AND TYPE 
CR, 15, 18 
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Messages (cont.) 

NO SUCH FILE, 7, 15, 18, 32 
OUTPUT DEVICE ERROR nnnnnnn, 

33 
PRESRV identification, 6 
STORAGE BITMAP FILES READ ERROR, 

5, 33 
SYNTAX ERROR, 23, 33 
TAPE LABEL READ ERROR, 33 
TAPE WAS WRITTEN FOR dd, 33 
TRANSFER SPECIFICATION MODE 

ERROR, 17, 33 
VERIFICATION ERROR nnnnnnn, 

12, 33 
VOLUME FAULTY - "R" TO RETRY, 
"C" TO CONTINUE, 13, 14 
Mixed Massbus peripherals, 26 
Mode 

core-dump, 28 
FILES- 11, 1, 5 
image, 1, 2 
logical tape, 1, 2 
Modifying switch, 7 
Monitor restoration, 28 
Mounting device, 6 
Multi-volume files, 2 



Non-identical media, 5 
Normal vector, 24, 25 
NO SUCH FILE message, 7, 15, 
18, 32 



Option switches, list of, 8 - 11 
OUTPUT DEVICE ERROR nnnnnnn 

message, 33 
OUTPUT VOLUME OVERFLOW 

message, 33 
Outspec, modification of, 7 
Outspec/switch, 1, 7 
Overriding default blocking 

factors, 23 



/PE (Phase-Encoded tape) 

switch, 2, 9, 12, 16, 17, 

26 
Peripherals, mixed Massbus, 26 
Phase-Encoded tape (/PE 

switch) , 2, 9, 12, 16, 

17, 26 
Physical tape, 4 
Physical unit number, 10, 26 
Positioning tapes, 2 



PRESRV 

commands , 1 

description of, 1 

devices supported by, 1 

functions , 5 

identification message, 6 

memory requirements, 22 

services , 5 

services, to print summary of, 

10 
use of , 6 

Primary command switches , 11 
Abort on I/O Error (/ER) , 14 
FILES-11 mode (/FI) , 13 
Image Mode (/IM) , 11 
Logical Tape Mode (/TP) , 12 
Phase-Encoded tape (/PE) , 12 
Rewind at Completion (/RW) , 

13 
Verification (/VE) , 12 



Restoring disk 

from DECtape, 12, 18 
from magnetic tape (TUlO) , 15 
from magnetic tape (TU16) , 16 
Restoring the Monitor (/BO) 

switch, 28 
Rewind at completion (/RW) switch, 

8_, 13 
RH controller, 25, 26 
RK05 disk cartridge, 1, 10, 11, 

14, 15, 18, 19 
RP02 disk, 1, 10, 15, 19 
RP03 disk, 1, 10, 15, 19 
RP03 disk drive, 1, 10, 15, 19 
RP02/RP03 disk formatting, 19 
RP04 disk pack, 1, 6, 10, 12, 15, 

19, 25, 26 
RPll controller, 19 
RSTS/E system, 28 
RSX-llD system, 5 
RSX-llM system, 5 
RSX-llS executive, 6 
/RW (Rewind at Completion) switch, 
8, 13 



Sample run, 28 
Sample run, (Fig.), 30 
Sector identification, 19 
SELECT ERROR message, 33 
Services of PRESRV, 5 

printing summary of , 10 
Setting density to 200 bpi 
(/20) switch, i, 28 
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Setting density to 556 bpi 

(/55) switch, 9, 28 
Setting density to 800 bpi 

(/BO) switch, 9_, 28 
Stand-alone switches 
/BO, 28 
/HE, 6, 10 
/LI, 26 
/TIM, 9, 27 
STORAGE BITMAP FILES READ 

ERROR message, 5, 33 
Switches 

Abort on I/O Error (/ER) , 

8, 14 
Auxiliary command, 19 
Blocking, (/BL) , 8, 14, 16, 

17, 22, 23 
Bootstrap (/BO) , 9^, 28 
Control Status Register 

(/CSR) , 6, 7, 9, 24, 26 
Device specific, 9^, 28^ 
see also Device specific 

FILES-11 mode (/FI) , 10, 13 
Format Enable/Normal, Tr9 
Formatting Disk (/FO) , 5, 

10, 19 
Hardware specific, 23, see 

also Hardware specific 

switches 
Help command (/HE) ,6,10 
Image Mode (/IM) , 10, ir7 

12, 14, 16, 17, T8 
Listing (/LI) , 1£, 26 
Logical Tape Mode {JTV) , 

8, 12, 17, 18, 21 
Modifying, 7 
Phase-Encoded Tape (/PE) , 

2, 9, 12, 16, 17, 26 
Primary command, 11, see also 

Primary command switches 
Restoring the Monitor (/BO) , 

28 
Rewind at Completion (/RW) , 

i, 13 
Setting density to 200 bpi 

(/20), 9, 28 
Setting density to 556 bpi 

(/55), 9, 28 
Setting density to 800 bpi 

(/80), 9, 28 
Stand-alone, auxiliary, 26, 

see also Auxiliary stand- 
alone switches 
Time and Date (/TIM) , 9, 27 
TM02 Formatter (/TM02) , 10, 

25, 26 — 



Switches (cont.) 

Unit (/Unit) , 10, 26 

Vector (/VEC) ,T, 10, 24, 26 

Verify (/VE) , 11, 12, IT, 16, 
17, 18, 20, 2T 
Switches, list of, 8 - 11 
SYNTAX ERROR message, 23, 33 
System crash, 7 
Systems 

IAS , 5 

RSTS/E, 28, 29 

RSX-llD, 5 

RSX-llM, 5 



Tape, 

density, 9, 28 
logical label block, 4 
logical mode, 1, 2 
mark, end-of-file, 2, 17 
Phase-Encoded (/PE) switch, 2, 

9, 12, 16, 17, 26 
physical, 4 
positioning, 2 

Tape devices, see Magnetic tape 

devices 
TAPE LABEL READ ERROR message, 33 
TAPE WAS WRITTEN FOR dd message, 

33 
Time default, 27 
Time (/TIM) switch, 9, 27 
Timing identification, 19 
/TIM (Time) switch, 9^, 27 
TM02 tape formatter, 10, 25^, 26 
/TM02 (TM02 formatter) switch, 

10, 25, 26 

/TP (Logical Tape Mode) switch, 

8, 12, 17, 18, 21 
Trailing decimal point, 23 
TRANSFER SPECIFICATION MODE 

ERROR message, 33 
TS03 magnetic tape device, 1, 2 
TUlO magnetic tape drive, 1, 2, 9, 

14, 15, 17, 28 
TU16 magnetic tape drive, 1, 2, 9, 

12, 16, 17, 21, 25, 26 



Unit number, physical, 7, 10, 26 
Unit (/Unit) switch, 10, 26 



Vector addresses 

list of, 24 
Vector address (/VEC) switch, 7, 

10, 24, 26 
Vector, normal, 24, 25 
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/VEC (Vector Address) switch, 7, Write error, 14 

10, 24, 26 Write-ring, 11 

VeriTTcatTon (/VE) switch, 11, 

12, 14, 16, 17, 18, 20,^11 
VerifTcation of copy operation, 

see copy operations , 

verification of 
VERIFICATION ERROR nnnnnnn 

message, 12, 33 
Verification failure, 12 
/VE (Verification) switch, 11, 

12, 14, 16, 17, 18, 20, 21 
VOLUME FAULTY - "R" to RETRY, 

"C" to CONTINUE message, 

13, 14 

Volume number error, 16 
Volumes, multi-volume files, 2 
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Did you find errors in this manual? If so, specify by page. 
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